home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / IDLIncludes / TranslationExtensions.idl < prev    next >
Text File  |  1996-05-01  |  4KB  |  109 lines
  1. /*
  2.      File:        TranslationExtensions.idl
  3.  
  4.      Contains:    Macintosh Easy Open Translation Extension Interfaces.
  5.  
  6.      Version:    Technology:    Macintosh Easy Open 1.1
  7.                  Release:    Universal Interfaces 3.0d3 on Copland DR1
  8.  
  9.      Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10.  
  11.      Bugs?:        If you find a problem with this file, send the file and version
  12.                  information (from above) and the problem description to:
  13.  
  14.                      Internet:    apple.bugs@applelink.apple.com
  15.                      AppleLink:    APPLE.BUGS
  16.  
  17. */
  18. #ifndef __TRANSLATIONEXTENSIONS_IDL__
  19. #define __TRANSLATIONEXTENSIONS_IDL__
  20.  
  21. #include <somobj.idl>
  22. #include <somcls.idl>
  23.  
  24. #ifndef __MEMORY_IDL__
  25. #include <Memory.idl>
  26. #endif
  27. #ifndef __FILES_IDL__
  28. #include <Files.idl>
  29. #endif
  30. #ifndef __QUICKDRAW_IDL__
  31. #include <Quickdraw.idl>
  32. #endif
  33. #ifndef __COMPONENTS_IDL__
  34. #include <Components.idl>
  35. #endif
  36.  
  37. #ifdef __SOMIDL__
  38.  
  39. /* better names for 4-char codes*/
  40. typedef OSType                    FileType;
  41.  
  42. typedef ResType                    ScrapType;
  43.  
  44. typedef unsigned long            TranslationAttributes;
  45.  
  46. typedef SOMLargeStruct            FileTypeSpec;                /* Derived from a struct of 20 bytes in size */
  47.  
  48. typedef SOMLargeStruct            FileTranslationList;        /* Derived from a struct of 8 bytes in size */
  49.  
  50. typedef OpaquePtr                FileTranslationListPtr;        /* Substituted OpaquePtr for ``FileTranslationList*'' */
  51.  
  52. typedef OpaquePtr                FileTranslationListHandle;    /* Substituted OpaquePtr for ``FileTranslationListPtr*'' */
  53.  
  54. typedef SOMLargeStruct            ScrapTypeSpec;                /* Derived from a struct of 8 bytes in size */
  55.  
  56. typedef SOMLargeStruct            ScrapTranslationList;        /* Derived from a struct of 8 bytes in size */
  57.  
  58. typedef OpaquePtr                ScrapTranslationListPtr;    /* Substituted OpaquePtr for ``ScrapTranslationList*'' */
  59.  
  60. typedef OpaquePtr                ScrapTranslationListHandle;    /* Substituted OpaquePtr for ``ScrapTranslationListPtr*'' */
  61.  
  62. /* definition of callbacks to update progress dialog*/
  63. typedef long                    TranslationRefNum;
  64.  
  65. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  66. /*
  67. ****************************************************************************************
  68. *
  69. * This routine sets the advertisement in the top half of the progress dialog.
  70. * It is called once at the beginning of your DoTranslateFile routine.
  71. *
  72. * Enter:    refNum            Translation reference supplied to DoTranslateFile.
  73. *            advertisement    A handle to the picture to display.  This must be non-purgable.
  74. *                            Before returning from DoTranslateFile, you should dispose
  75. *                            of the memory.  (Normally, it is in the temp translation heap
  76. *                            so it is cleaned up for you.)
  77. *
  78. * Exit:    returns            noErr, paramErr, or memFullErr
  79. */
  80. /*
  81. ****************************************************************************************
  82. *
  83. * This routine updates the progress bar in the progress dialog.
  84. * It is called repeatedly from within your DoTranslateFile routine.
  85. * It should be called often, so that the user will get feedback if he tries to cancel.
  86. *
  87. * Enter:    refNum        translation reference supplied to DoTranslateFile.
  88. *            progress    percent complete (0-100)
  89. *
  90. * Exit:        canceled    TRUE if the user clicked the Cancel button, FALSE otherwise
  91. *            returns        noErr, paramErr, or memFullErr
  92. */
  93. /* ComponentMgr selectors for routines*/
  94. /* Routines to implment in a file translation extension*/
  95. typedef OpaquePtr DoGetFileTranslationListProcPtr;
  96. typedef OpaquePtr DoIdentifyFileProcPtr;
  97. typedef OpaquePtr DoTranslateFileProcPtr;
  98. typedef OpaquePtr DoGetTranslatedFilenameProcPtr;
  99. /* Routine to implement in a scrap translation extension*/
  100. typedef OpaquePtr DoGetScrapTranslationListProcPtr;
  101. typedef OpaquePtr DoIdentifyScrapProcPtr;
  102. typedef OpaquePtr DoTranslateScrapProcPtr;
  103. #endif
  104.  
  105. #endif /* __SOMIDL__ */
  106.  
  107. #endif /* __TRANSLATIONEXTENSIONS_IDL__ */
  108.  
  109.